home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Atari Mega Archive 2
/
Atari Mega Archive CD - Volume 2.iso
/
minix
/
up1510b.tgz
/
up1510b
/
doc
/
stevie.doc
< prev
next >
Wrap
Text File
|
1990-07-19
|
29KB
|
1,057 lines
STEVIE - An Aspiring VI Clone
User Reference - 3.44
Tony Andrews
1. _✓O_✓v_✓e_✓r_✓v_✓i_✓e_✓w
STEVIE is an editor designed to mimic the interface of the
UNIX editor 'vi'. The name (ST Editor for VI Enthusiasts)
comes from the fact that the editor was first written for
the Atari ST. The current version has been ported to UNIX,
Minix, MS-DOS, and OS/2, but I've left the name intact for
now.
This program is the result of many late nights of hacking
over the last year or so. The first version was written by
Tim Thompson and posted to USENET. From there, I reworked
the data structures completely, added LOTS of features, and
generally improved the overall performance in the process.
I've labelled STEVIE an 'aspiring' vi clone as a warning to
those who may expect too much. On the whole, the editor is
pretty complete. Almost all of the visual mode commands are
supported. I've tried very hard to capture the 'feel' of vi
by getting the little things right. Making lines wrap
correctly, supporting true operators, and even getting the
cursor to land on the right place for tabs are all a real
pain, but really help make the editor 'feel' right.
STEVIE may be freely distributed. The source isn't copy-
righted or restricted in any way. If you pass the program
along, please include all the documentation and, if practi-
cal, the source as well. I'm not fanatical about this, but I
tried to make STEVIE fairly portable and that doesn't do any
good if the source isn't available.
The remainder of this document describes the operation of
the editor. This is intended as a reference for users
already familiar with the real vi editor.
2. _✓S_✓t_✓a_✓r_✓t_✓i_✓n_✓g__✓t_✓h_✓e__✓E_✓d_✓i_✓t_✓o_✓r
The following command line forms are supported:
stevie [file ...] Edit the specified file(s)
stevie -t tag Start at the location of the given tag
stevie + file Edit file starting at end
- 1 -
STEVIE User Reference
stevie +n file Edit file starting a line number 'n'
stevie +/pat file Edit file starting at pattern 'pat'
If multiple files are given on the command line (using the
first form), the ":n" command goes to the next file, ":N"
goes backward in the list, and ":rew" can be used to rewind
back to the start of the file list.
3. _✓S_✓e_✓t__✓C_✓o_✓m_✓m_✓a_✓n_✓d__✓O_✓p_✓t_✓i_✓o_✓n_✓s
The ":set" command works as usual to set parameters. Each
parameter has a long and an abbreviated name, either of
which may be used. Boolean parameters are set as in:
set showmatch
or cleared by:
set noshowmatch
Numeric parameters are set as in:
set scroll=5
Several parameters may be set with a single command:
set novb sm report=1
To see the status of all parameters use ":set all". Typing
":set" with no arguments will show only those parameters
that have been changed. The supported parameters, their
names, abbreviations, defaults, and descriptions are shown
below:
- 2 -
STEVIE User Reference
autoindent Short: ai, Default: noai, Type: Boolean
When in insert mode, start new lines at the same
column as the prior line. Unlike vi, you can
backspace over the indentation.
backup Short: bk, Default: nobk, Type: Boolean
Leave a backup on file writes.
errorbells Short: eb, Default: noeb, Type: Boolean
Ring bell when error messages are shown.
ignorecase Short: ic, Default: noic, Type: Boolean
Ignore case in string searches.
lines Short: lines, Default: lines=25, Type: Numeric
Number of physical lines on the screen. The
default value actually depends on the host
machine, but is generally 25.
list Short: list, Default: nolist, Type: Boolean
Show tabs and newlines graphically.
number Short: nu, Default: nonu, Type: Boolean
Display lines on the screen with their line
numbers.
report Short: report, Default: report=5, Type: Numeric
Minimum number of lines to report operations on.
return Short: cr, Default: cr, Type: Boolean
End lines with cr-lf when writing files.
scroll Short: scroll, Default: scroll=12, Type: Numeric
Number of lines to scroll for ^D & ^U.
showmatch Short: sm, Default: nosm, Type: Boolean
When a ), }, or ] is typed, show the matching (,
{, or [ if it's on the current screen by moving
the cursor there briefly.
showmode Short: mo, Default: nomo, Type: Boolean
Show on status line when in insert mode.
tabstop Short: ts, Default: ts=8, Type: Numeric
Number of spaces in a tab.
wrapscan Short: ws, Default: ws, Type: Boolean
String searches wrap around the ends of the
file.
- 3 -
STEVIE User Reference
vbell Short: vb, Default: vb, Type: Boolean
Use a visual bell, if possible. (novb for audi-
ble bell)
The EXINIT environment variable can be used to modify the
default values on startup as in:
setenv EXINIT="set sm ts=4"
The 'backup' parameter, if set, causes the editor to retain
a backup of any files that are written. During file writes,
a backup is always kept for safety until the write is com-
pleted. At that point, the 'backup' parameter determines
whether the backup file is deleted.
In environments (e.g. OS/2 or TOS) where lines are normally
terminated by CR-LF, the 'return' parameter allows files to
be written with only a LF terminator (if the parameter is
cleared). This parameter is ignored on UNIX systems.
The 'lines' parameter tells the editor how many lines there
are on the screen. This is useful on systems like the ST
(or OS/2 machines with an EGA adapter) where various screen
resolutions may be used. By using the 'lines' parameter,
different screen sizes can be easily handled.
4. _✓C_✓o_✓l_✓o_✓n__✓C_✓o_✓m_✓m_✓a_✓n_✓d_✓s
Several of the normal 'vi' colon commands are supported by
STEVIE. Some commands may be preceded by a line range
specification. For commands that accept a range of lines,
the following address forms are supported:
addr
addr + number
addr - number
where 'addr' may be one of the following:
a line number
a mark (as in 'a or 'b)
'.' (the current line)
'$' (the last line)
An address range of "%" is accepted as an abbreviation of
"1,$".
- 4 -
STEVIE User Reference
4.1 _✓T_✓h_✓e__✓G_✓l_✓o_✓b_✓a_✓l__✓C_✓o_✓m_✓m_✓a_✓n_✓d
A limited form of the global command is supported, accepting
the following command form:
g/pattern/X
where X may be either 'd' or 'p' to delete or print lines